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Preface: 



This K-DOS Handbook is designed to acquaint and instruct the 
user with K-DOS, an improved version of a Disk Operating 
System for the Atari* BOO™. The primary purpose is to 
describe and exemplify the commands necessary to manipulate 
data to and from the disk drive[s]. 



SECTION I 



SECTION II 



SECTION III 



SECTION IV 



SECTION V 



explains the general contents of K-DOS and 
lists the system master diskette files. An 
overall description of K-DOS features is 
summarized with comparisons and compat- 
ibility to Atari's 2. OS. 

is a handy guide to assist the user with 
important features, such as terminology, 
symbols, and syntax conventions used in 
this handbook. 

summarizes the procedures for powering 
up equipment, including the console, disk 
drive[s], and other peripherals. Memory 
allocations are suggested for use, and the 
K-DOS operation is examined. 

gives a more detailed listing of the actual 
features in both the File Management 
System [FMS] and Disk Utility Program 
[DUP], 

details the essential instructions for 
successfully directing K-DOS commands. 
These commands are categorized according 
to type of command for easy usage, i.e. 
according to disk, file, program, monitor, 
device, etc. Each category is complete with 
examples. 

The appendices include error messages, 
FMS patches, a glossary and an index for 
the user's convenience. 



* ATARI is a registered trademark of ATARI, INC. 
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Introduction 



K-DOS, a command-driven DOS, offers more powerful and 
convenient features than Atari's DOS 2. OS; therefore, it is 
easier to use. K-DOS permits the user to access disk files and 
easily manipulate data in numerous ways, i.e. save or load 
programs, append or delete files, alter memory locations, etc. 
One of the most significant features of K-DOS includes a 
machine language monitor which allows the user to examine 
and alter memory. K-DOS is always memory resident, so it is 
not necessary to load K-DOS from a disk each time it is used. In 
addition, K-DOS supports the Atari 850™ handler, the 
operating system program which allows the use of other 
devices such as printers and modems. 

K-DOS offers the following advantages: 

1 ] Convenience 

[a] K-DOS does not have to be loaded each 
time it is used. 

[b] K-DOS will persist to load a program until it 
loads correctly. 

[c] K-DOS defaults filenames and wildcards to 
give greater adaptability. 

[d] K-DOS allows English commands to be 
abbreviated. 

2] Flexibility 

[a] User Defined Commands allow the user to 
create personalized commands. 

[b] DOS Character feature permits DOS 
commands to be executed when the BASIC 
or ASSEMBLER cartridge is in control. 

3] Understandability 

Error messages are given in English so they 
are more readily understood. 



4] Control 

New powerful commands, such as COLD 
and LOMem, offer more control over the 
system. 



5] Reliability 

Writing large blocks of memory is safer. 

The special master diskette accompanying K-DOS includes the 
following K-DOS system files: 



DOS. SYS 
TRANS. SYS 

UDC. SYS 
CHERROR.SYS 

SQUEEZE.SYS 



DISKDUP.SYS 
HELP.SYS 



EQUATE. ASM 
DEQU.ASM 



FMS & DUP [always memory resident]. 

TRANS command used to transfer files on 
a single drive system [UDC]. 

UDC command. 

A file that lists error messages and allows 
user to change those messages [UDC]. 

The program SQUEEZE will remove error 
messages and optionally allow removal of 
the UDC tables from K-DOS, giving the 
user additional memory space. 

DISKDUP command used to duplicate 
diskettes [UDC]. 

The HELP command [UDC]. When running 
this program [Type HELP or just H], user 
will get a brief summary of all legal K-DOS 
commands. 

A system equate file. 

An equate file to entry points inside of DOS 
[global addresses, including user callable 
subroutines]. 



HELPFILE.SYS The file that the HELP command copies. 
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The master diskette is write-protected for your protection. 
We recommend that you use DISKDUP [page 1 3] immediately 
to make a duplicate of the original, storing it in a secure place 
where you are not tempted to use it. It is advisable to duplicate 
[back up] any disk with valuable files to insure against the loss of 
important information. Write-protecting a disk also prevents 
you from accidentally writing over and destroying pertinent 
information. For further instructions on write-protection, see 
the Atari DOS Manual. 



The K-DOS file format is totally compatible with Atari's 2. OS. 
Optional programs and products you may find useful with 
K-DOS include: 



1 ] K-COM I, a cartridge-based communications system which 
turns your Atari into a smart terminal. K-COM I is available 
through K-BYTE, P.O. Box 456, 1705 Austin, Troy, Ml 
48099. 



2] ASM/ED cartridge by Atari which includes a TEXT EDITOR, 
as well as an ASSEMBLER and a more sophisticated 
DEBUGGER. 



3] FIX, available through APX, which allows one to recover 
from certain kinds of disk catastrophies, such as recovering 
files accidentally erased and "cleaning" a disk whose VTOC 
[Volume Table of Contents] is erased. 



4] Atari Disk Operating System II Reference Manual 
#C016347. 



5] Atari Disk Personal Computer System Operating System 
User's Manual #C01 6555. 



SECTION II Symbols 



[ ] 



{ } 



indicates keys on the keyboard 

[break] to terminate an operation 

[CTRL1 ] to pause output to the screen 

[CTRL3] to indicate end of file 

[return] to send input to the computer; 

press [return] after each 
command 

to take you back into DOS 

pressed simultaneously with 
[start] will get you directly 
into DUP, bypassing the car- 
tridge 

indicates optional parts 

Ex. WBOOT {n} 
Proceed {hhhh} 

indicates a switch used to modify the action of 
certain commands 



[system reset] 
[system reset] 
[start] 



Command 


Switch 


Meaning 


DISKdup 


/All 


all sectors 


Save 


/Append 


add data to existing file 


DISKdup 


/Forever 


retry continuously 


Run 


/Map 


load map of the records is to 


Load 




be displayed as program is 
loaded 


Run 


/Noinit 


load into memory, but do not 


Load 




initialize 



DELete /Noquery 

Run /Patch 
Load 

DISKdup s /Put 



indicates manipulation of file 
without asking permission 

ignore memory range error; 
will then load over DOS 

means that each sector is not 
checked after it is written 
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TRansfer /SIRG 
DISKdup AA/rite 



comma: 



space: 



ellipsis: 
asterisk: 



colon: 



hhhh 



short interrecord gaps 

when destination is written, 
disk drive checks to insure file 
was written correctly 

optional use in the format of a 
command 

necessary in commands, par- 
ticularly when replacing a 
comma 

indicates previous parts may 
be repeated 

[1] wildcard: used to replace 
combination of characters 

[2] locked file: will appear 
before file in the directory 
to show it is locked 

[1] wildcard: used to replace 
one character at a time 

[2] "this message 11 see page 
14. 

underlining of commands 
denotes the proper abbrevia- 
tion necessary for the 
successful execution of a 
command 

Ex. DELete 
LQM em 

denotes minimum abbreviation 
when defining a UDC 

used each time you refer to a 
device in DOS 

D: disk drive 
P: printer 

denotes a hexadecimal number 



SECTION III Powering Up 



A. K-DOS boots the same way as Atari's DOS boots. 

1 . Turn on television set or monitor. 

2. Turn on all disk drives. 

3. Turn on the Atari 850 [interface module] if you 
intend to use any peripherals, such as a printer or 
modem. 

4. Properly insert K-DOS master diskette into drive 1 
after the BUSY light goes out. 

5. Turn on computer console. K-DOS will now boot. 
The screen will display the K-DOS version as follows: 

K-DOS™ By K-Byte™ 

Copyright 1981 
KAY ENTERPRISES Co. 

If you should get a "Boot Error", turn off the computer console 
for a few seconds, then back on again. Should you continue to 
get a "Boot Error", check the door[s] of the disk drives and all 
connections. Further explanation of powering up is explained in 
the Atari DOS Reference Manual. 

B. Memory Allocations 

K-DOS requires 14K to load, including 2K for the 850 
handler. The utilities [DISKDUP, TRANS] require at least 
32Kto be useful. 
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C. K-DOS Executions 
K-DOS will: 

1 . Load itself into memory 

2. Initialize itself 

3. Boot in the 850's handler 

4. Print its title 

5. Look for an AUTORUN.SYS file [directs automatic 
run of a particular file] 

6. Enter any cartridge if present or else DOS itself*. 

*To enter K-DOS when the cartridge is in control, type "DOS" 
from the BASIC or ASSEMBLER cartridge, or press [system 
reset] while holding down [start]. K-DOS will respond with a 
"DOS" and wait for commands. 



SECTION IV Features 



K-DOS is divided into two parts: 



A. FMS-File Management System, the "control" 

program. 

B. DUP - Disk Utility Program, a set of utilities to execute 

commands called by the FMS. The DUP actually 
does the labor of the FMS. 



A. The FMS in this version of K-DOS offers the following 
features: 

1 . The [break] key will stop any I/O with the disk. You no 
longer need to strike it several times. 

2. Writing large blocks of memory is safer because it is no 
longer written directly from memory. With the Atari 
FMS, pressing [break] enough times to abort a SAVE 
from Basic would also destroy the program in memory. 

3. FMS will do status checking [check to see if the opera- 
tion is done correctly or if an error is encountered] of 
disk drives only on a COLD start. On [system reset], it 
uses the information it already has. 

4. Digits are now allowed for the first character of 
filenames; the Atari DOS requires the first character 
of a filename to be alphabetic. 

5. Appending a file has been made more efficient. The 
previous old block is utilized, eliminating wasted space 
and making the disk usage more efficient. 

B 



o 
o 

B. Features of the Disk Utility Program [DUP] are more 
recognizable than the features of the FMS. They include: 

1 . Machine language monitor. The Alter/Examine com- 
mands take advantage of the screen editor allowing the 
' user to examine and change memory in hexadecimal 

and display its ATASCII representation. The screen 
editor may be effectively used because the syntax used 
for changing locations is the same syntax as printed on 
the screen. 



2. English-like commands with abbreviations. The most 
common commands may be used with a single letter 
abbreviation; D,C,B, etc. More dangerous commands, 
INIT, FORMAT, COLD, DELete, and LOMem require 
more than one letter abbreviation to decrease the 
possibility of issuing an incorrect command which could 
wipe data out unintentionally. 

3. New powerful commands: LOMem, COLD. These 
commands allow more control over the system. 
LOMem may be used to reserve memory, while COLD, 
which coldstarts the cartridge, tells BASIC to erase 
memory. 

( 

4. English error messages for errors encountered by 
DUP and a way to retrieve them. "ERror nn" will 
display the error message associated with that nn 
[decimal number]. A list of error messages are given in 
Appendix A, as printed by the CHERROR.SYS file. 
Error numbers less than 1 28 are used for DUP errors. 
Some error messages are compatible with Atari 
BASIC. 



5. Interception of the BRK instruction, taking you back 
into DOS. A BRK in Atari DOS will usually crash the 
system. 

6. When the cartridge is in control, [system reset] 
pressed simultaneously with [start] will get you into 
DOS, bypassing the cartridge. 

O 



7. Easy to use and flexible syntax. 

a. filenames take digits as first character 

b. commas are optional when replaced by a space 

c. lower case input is accepted 

d. commands are abbreviated 

8. K-DOS compatability with Atari DOS 2. OS. Users 
familiar with the Atari DOS can easily adapt to the 
conveniences of K-DOS. 

9. DUP is memory resident. K-DOS does not have to be 
loaded from a disk each time it is used. 

1 0. UDC [User Defined Commands] permits the user to 
define a command that loads and runs a machine 
language program. 

11. DC [Defined Character] command. Allows DOS 
commands to be executed when the cartridge is in 
control. 

1 2. 850 handler is booted. 

13. User callable subroutines. Routines inside of DOS 
with simple I/O routines to change DOS itself. See 
DEQU.ASM file. 

14. NOTE and POINT work with the screen editor now. 
POINT is similar to BASIC'S Position statement and 
NOTE is the converse. These are used for consis- 
tency in "cleaning" rather than "poking" into 
memory. 

1 5. The inverse character flag is always reset should you 
accidentally hit the Atari symbol key. 
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SECTION V Commands 

This section describes in detail K-DOS commands. These 
commands are grouped into the following categories so that 
the user may easily refer to and access these commands. Each 
command is followed by examples to illustrate its function. A 
summary of commands may be found on page 30. 

A. Disk Preparation /Maintenance 

Getting disk ready for "storing" data 
Maintaining disk for duplication 

B. File Control 

Manipulation of files 

C. Program Control 

Management over the systems operations itself 

D. Machine Monitor 

Direct association with memory 

E. Device Control 

Management of devices, including peripherals 

F. DUP Special 

"User Defined Commands" 

G. Summary 
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A. Disk Preparation /Maintenance 

Every disk must be formatted before it can be used. "For- 
matted" means the disk is organized into tracks/ 
sectors so data can be written onto and read from the 
disk. You may format a disk with existing files, but you 
must be certain that you do not wish to preserve these 
files, because they are destroyed when the disk is 
formatted. 

There are 2 commands used to format a disk: 
1] INITn 

[n is required for disk number preceded by a 
space] 
FORMAT n 



2] 



2] 



TYPE: 

SCREEN 
DISPLAY: 

TYPE: 



SCREEN 
DISPLAY: 

=x. TYPE: 

SCREEN 
DISPLAY: 



IIMIT n 

Formats a disk on drive n, destroying all pre- 
vious information, but saves DOS. SYS out. 

INIT 1 

[to format disk on drive 1 ] 

Type Y to format disk 1 
Y 

[press [return] if you do not wish to format 
disk, otherwise, respond by typing Y] 

Saving DOS in D1 :DOS.SYS 
INIT 

Need 1 thru 8 for disk # 

FORMAT n 

Formats a disk on drive n, destroying all pre- 
vious information and reformatting sectors. 
Recommended for use when you need extra 
storage, but do not desire the ability to 
power up with the disk because DOS is not 
saved. If you desire DOS after you have 
used the FORMAT command, use WBOOT 
which is discussed next. Use FORMAT 
command if you intend to use DISKdup. 
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TVPE: 

SCREEN 
DISPLAY: 

TYPE: 



TYPE: 



x. TYPE: 

SCREEN 
DISPLAY: 

x. TYPE: 

SCREEN 
DISPLAY: 



FORMAT 1 

[to format disk on drive 1 ] 

Type Y to format disk 1 
Y 

[press [return] if you do not wish to format 
disk, otherwise, respond by typing Y] 

FORMAT 2 

[to format disk on drive 2] 
FORMAT 3 

[to format disk on drive 3] 

SCREEN DISPLAY corresponds to the 

above example for FORMAT 1 . 

WBOOT {n} 

Command will save DOS as Dn: DOS. SYS 
on drive n. Use after the FORMAT COM- 
MAND. Disk must be previously formatted 
before this command can be used. WBOOT 
may be used on a diskette that already has 
files without destroying those files. 

WBOOT [to save DOS on drive 1 ] 

Saving DOS IN D1 :DOS.SYS 
WBOOT 2 [to save DOS on drive 2] 

Saving DOS in D2:DOS.SYS 

DISK dup {scr{{,}dest}{/AI!} 
{ / Write } { / Forever } { / Put } } 

A UDC command used to duplicate the 
entire contents of a disk onto another disk. 
This command will run a program, DISK- 
DUP. SYS which copies an entire disk, 
sector by sector. It does this by using all of 
free memory as a buffer to read in sectors, 
and then writes them out. If there is not 
sufficient memory to hold the entire disk, it 
will proceed to make more passes. 



13 



If only one drive is specified, DISKdup will 
prompt you to insert the source and desti- 
nation disks. If arguments are given, they 
will be fed to the program, or you may type 
them in at that time. A [return] or [break] 
in response to "Source, dest " will exit the 
program. 

/All 

specifies that all sectors, without regard to 
the directory, are to be copied. Use this if 
the disk was not formatted by DOS. 

/Write 

specifies that when the destination is 
written, the disk drive is to check that it 
was written correctly. 

/Put 

means that each sector is not checked 
after it is written. 

/Forever 

means you may retry for as long as you 
wish. If you should hit [break], or if it should 
give up a sector, it will stop and respond 
with "Type C, S, Q, A, or ? for help". 

C continue trying 
S skip 

Q quit after this pass 
? this message 
A abort immediately 

DISKdup will warn you if it could not read or 
write a sector correctly, and will also tell 
you how many sectors it copied and how 
many errors it encountered. 
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:x. TYPE: DISK 

SCREEN Disk duplicate V1 .8 
DISPLAY: From [,to] 
? 

TYPE: 1 

SCREEN Insert source disk, type [return] 
DISPLAY: ? 

Insert destination disk, type [return] 



SCREEN 
DISPLAY 

Ex. TYPE 

SCREEN 
DISPLAY 



[The above instructions will be given until 
disk is copied correctly.] 

# sectors copied 
DISK 1/F 

Insert source disk, type [return] 

r, 

Insert destination disk, type [return] 
? 

[Instructions repeated] 

# sectors copied 



File Control 

The following eight commands may be used to manipulate 
files. 

Direct 
Copy 
DELete 



1] 
2] 
3] 
4] 

5] 
6] 



LOC k 

LJNIock 

REName 



7] APpend 
8] TRansfer 

Direct {filespec} {, output} 

To list the disk directory of the specified 
files. The filename, extender, and number of 
sectors will be displayed. The input defaults 
to D1 : * . * and output defaults to the screen 
editor; E:. Wildcards may be used. 
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Ex. TYPE: D 

Prints a directory of all files on drive 1 to the 
screen. 

D2 

Prints a directory of all files on drive 2 to the 
screen. 

D H* 

Prints all files whose filenames begin with 
the letter H. * is used as a wildcard. 

D ,P: 

Prints a disk directory on the printer. 

S] Copy input {, output } 

To copy the input file to the output file. The 
output defaults to the screen editor, E:. To 
just look at a file, type C filename followed by 
[return]. 

TYPE: C TEST. TXT 

This lists the file TEST. TXT to the screen. 
Tokenized Basic programs will appear as 
mostly garbage. 

TYPE: C FILE1 FILE2 

To copy FILE1 to FILE2 on the same disk on 
drive 1 . 

TYPE: C MONEY D2:EXPENSES 

To copy a file named MONEY on drive 1 to a 
disk on drive 2 and call file EXPENSES. 

TYPE: CE:,SWIM 

To create small text files. TYPE: C E:, 

filename [return]. Type in your text. 

Breaststroke 

Backstroke 

Butterfly 

Freestyle 

[CTRL3] 

Press [CTRL3] for end of file. Remember 
to press [return] before [CTRL3] because 
the text on the line with the [CTRL3] is not 
sent to file. 
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TYPE: 



TYPE: C SWIM 

To look at a file called SWIM on the screen. 

type: C filename 

If the file is less than 20 lines, the screen 
editor can be used as a text editor. 

To list the file: Use cursor keys to edit the 
file. Insert an E: after the C, then enter this 
line and all others in the file. Press [CTRL3]. 
File has then been edited and changed 
accordingly. 

type: C PRETTY. ASM.P: 

File PRETTY is copied on the printer. 

C PRETTY. OB J, N: 

File PRETTY is copied to the dummy device. 
This can be used to verify that the file is 
okay and can be read. 

DEL ete filespec {/Noquery} 

To eliminate any file you no longer want on 
your diskette. You will be asked if you want 
to delete the file unless the /N switch is 
specified. 

DEL PIC2 

To delete file called PIC2 
Type Y to delete 

D1 :PIC2 Press [return] to keep file 
Y [return] 
DEL NAME/N 

To delete file called NAME without being 
asked. 

DOS 



3] 



x. TYPE: 

SCREEN 
DISPLAY: 

TYPE: 
x. TYPE: 



SCREEN 
DISPLAY: 



4] LQC k filespec 

To lock the indicated file[s]. These files can- 
not be accidentally deleted or written to 
until unlocked. 



17 



Ex, TYPE: 



5] 



Ex. TYPE: 



Ex. TYPE: 



TYPE: 



CAUTION: 



Ex. TYPE: 



TYPE: 



LOC DRIVER, ASM 

After file DRIVER. ASM is locked, you will 
find an * preceding the locked file in the 
directory. When you attempt to write to a 
locked file, you will encounter ERROR 1 67, 
File Locked. 

UIM Iock filespec 

To unlock the indicated file[s]. 
UN DRIVER. ASM 
If you want a locked file to become acces- 
sible, the UNIock command will reverse the 
LOCk command so that the file can now be 
written to or deleted. In the directory, the * 
no longer precedes the filename. 

G] RE Name file, filename 

To change the name of a file. 
REN CHECKS, PAYROLL 
To change the name of file CHECKS to 
PAYROLL on drive 1 . 
REN D2:SUSAN, SUE 
To change file SUSAN to SUE on drive 2. 
It is not a good idea to give two files the 
same name. 

AP pend {sourcef ile,} destfile 

To add data to the end of an old file. 
AP DRIVER. ASM, MAZER. ASM 
File DRIVER. ASM is added to the end of file 
MAZER. ASM. 
AP STATE.TXT 
GEORGIA 
ALABAMA 
TENNESSEE 
FLORIDA 
[CTRL3] 

The source file defaults to E: so the text 
typed is appended to the destination file 
when no source file is specified. Small text 
file is added to STATE.TXT. 
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S] 



Ex. TYPE: 



SCREEN 
DISPLAY: 

Ex. TYPE: 



TR ansfer filename {/SIRG} 
{.filename} {/SIRG} 

To duplicate a file on a one-drive system. 
This command will take a file from the 
diskette, store it in memory, and then 
transfer it to another diskette. The pro- 
gram memory is used as a buffer, so it can 
read the entire file with one read. This is a 
UDC program in the file TRANS. SYS. 

TR PRETTY. ASM 

To transfer file PRETTY. ASM from one disk 
to another, alternating disks several times 
depending upon the length of the file. 
Set up source, [return] 
Set up destination, [return] 

TR PRETTY,C:/SIRG 

/ S I R G is used when transferring data to a 
cassette. 



C. Program Control 

These commands issue management over the systems 
operations inclusively; getting back to the cartridge, 
returning DOS to whatever called it, etc. 

1] Back 

2] WARM 

3] COLD 

4] Xit 

5] UNLOAD 

6) LOM em 

7] DC {character} 

1] Back 

This is the official way to get back to the 
cartridge, BASIC or ASSEMBLER cartridge. 
If BASIC, then BASIC is in control. 

Ex. SCREEN 

DISPLAY: DOS 



TYPE: 

SCREEN 
DISPLAY: 



B 

READY 

If you have the BASIC cartridge inserted. 
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or 



SCREEN EDIT 

DISPLAY: Takes you back to the ASSEMBLER 
cartridge. 



or 

SCREEN 
DISPLAY: 

REMEMBER: 



No cartridge 

When cartridge has not been inserted. 
To get back to DOS, type DOS or press 
[system reset] and [start] simultaneously. 



2) WARM 

To force a warm start, to reinitialize with- 
out changing memory, to close files, to 
reset pointers without erasing memory. 
Use only if you think DOS might be confused 
about the cartridge. [This command is 
useful after RESET command, when you are 
certain cartridge's memory is intact.] 

Ex. SCREEN 

DISPLAY: DOS DOS 

TVPE: WARM WARM 
SCREEN READY [BASIC] READY [ASSEMBLER] 



3] 



:x. 



SCREEN 
DISPLAY 

TYPE 

SCREEN 
DISPLAY 

TYPE 

SCREEN 
DISPLAY 



COLD 

To coldstart the cartridge. Like NEW in 
BASIC or in the EDIT/ASM. but more 
thorough because it erases the program 
area [user area] of memory. 

DOS 
COLD 

Type Y if okay to coldstart cartridge? 
Y 

EDIT [ASSEMBLER] 
READY [BASIC] 
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4] Xit 

Tells DOS to return to wherever it was 
executing: Another way to get back to the 
cartridge. In BASIC, if DOS was called from 
a program, the program will continue. 



SCREEN 
DISPLAY: DOS 

TYPE: X 



SCREEN 
DISPLAY: 



READY [BASIC] 



5] UNLOAD 

Tries to erase area where cartridge is; 
unloads any RAM based cartridge and 
resets LOMem back to the end of DOS. 
Program inserted between DOS and 
LOMem area is erased. 

SCREEN 
DISPLAY: DOS 

TYPE: UNLOAD 

SCREEN 

DISPLAY: Type Y if ok to coldstart cartridge? 

TYPE: Y 



SCREEN 
DISPLAY: 



DOS 



6] LOM em {hhhh} 

Sets the bottom of memory for a cartridge. 
This can be used to reserve memory for a 
machine language subroutine that you do 
not want the cartridge to "play" with. Since 
this means that the cartridge's memory 
space has been moved, the cartridge is cold 
started. If {hhhh} is omitted, a summary of 
memory usage is printed. 
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LOM 

DOS Bottom Low High Top 
2F58 31 D8 31 D8 31 D8 9C1 F 

LOM 2F58 

Low memory must be at least 31 D8. 
2F58-31 D7 is used for disk buffers. 

LOMem out of range. 
DC {character} 

Allows user to define a character, such as a 
and when character is defined , the DOS 
commands may be used with the cartridge. 

DC/ 

DOS 
B 

READY 
/C PRETTY 

The default is "/'■ DC with no character 
turns the feature off. Use WBOOT to save 
this character on the disk if you always want 
your character to be different than a 
The DC character by itself puts you some- 
where between BASIC and DOS. [CTRL3] 
takes you back to BASIC. Type "DOS" to 
get back to DOS. 

Machine Monitor 

The following commands allow the user to deal directly with 
memory; to examine memory, to change memory, etc. 

1] Run 

2] Load 

3] Save 

4] Go 

5] Proceed 

6] Examine 

7] Alter 

8] REgister 



Ex. TYPE: 

SCREEN 
DISPLAY: 

Ex. TYPE: 



SCREEN 
DISPLAY: 



7) 



■x. TYPE: 

SCREEN 
DISPLAY: 

TYPE: 

SCREEN 
DISPLAY: 

TYPE: 
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1] Run file {/Map} {/Noinit} {/Patch} 

To load an object file and run it. If the pro- 
gram loads over the program area, the 
loader will ask you if you want to coldstart 
the cartridge. 

/Map 

denotes a load map of records is displayed 
as it is loaded. 



Ex. TYPE; R PRETTY. OB J/M 



/Noinit 

specifies that file may be loaded in memory, 
but do not initialize. This switch will prevent 
a normal LOAD to run this program. 



Ex. TYPE: R PRETTY. OB J/N 



Ex. TYPE: 

SCREEN 
DISPLAY: 



/Patch 

specifies that memory range error is to be 
ignored. Pointers will load in where file 
instructs it to be loaded. It will then load 
over DOS. 

R D2:HERE/M/N 
6000-6090 
02E0-02E3 
6010 INIT 
6020 GO 
BRK at 6020 



2] Load file {/Map} {/Noinit} {/Patch} 

To load a file into memory. It can be run with 
the Go command, if it has a run address [at 
S2E0]. 

/Map 

denotes a load map of records is displayed 
as it is loaded. 

/Noinit 

specifies that a file is NOT to be initialized. 
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Ex. TYPE: 

SCREEN 
DISPLAY: 



3} 



Ex, TYPE: 
4] 



Ex. TYPE: 
5] 



Ex. SCREEN 
DISPLAY: 

TYPE: 



/Patch 

ignore memory range error; load in where 

file instructs. 

L D2:HERE/M/N 

6000-6090 

02E2-02E3 

6010 INIT 

6020 GO 

Save file {/Append} beg end 
{{init} start} 

To save memory on a disk file. Locations 
$2E2 and $2E3 will be set to the run 
address for the Run command. All 
addresses are hexadecimal. 
/Append 

Adds data to the object file without writing 

another object file header. 

S D2:HERE 6000 6090 6010 6020 

Go {hhhh} 

To start execution at the indicated hexa- 
decimal address [or at the last loaded or 
saved file's run address]. Note that this 
command does an implicit CLOSE command 
and doesn't load the registers with their 
stored values. A return address is left on 
the stack so RTS will return control to DOS. 
This may be used to restart UDC. 
G 5000 

Proceed {hhhh} 

To continue execution from a BRK instruc- 
tion. Change the PC if {hhhh} is specified. 
This command does not change the regis- 
ters, and does NOT close files. It can be 
used with the BRK instruction and the Alter 
command to set breakpoints to debug a 
machine language program. 

Brk at 0602 
P or P 403E 
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G] 



Ex, TYPE: 



Examine { irst ► {, ^last^ } } 

To look at memory in hexadecimal and 
ATASCII. The format is: addr-«h1 h2 h3 h4 
h5 h6 h7 h8 "1 2345678, compatible with 
the Alter command. The Examine command 
defaults to the last of the following: after 
last Examine command, last Alter com- 
mand, last loaded program or run address if 
present. Examine n will report 8 bytes 
starting at n. 

E 5000,501 D or 
E 700 or 



"7] 



NOTE: 



Ex. TYPE: 



Alter { hhhh}^{hh}{,}{hh}{,}..... 
garbage 

Alter {hhhh} ■< ' ascii 

or (implicit mode] {hhhh} 

(same as above] 

To change memory in hexadecimal or 
ATASCII. $60, a diamond or grave accent 
[non-displayable characters] on the printer 
cannot be deposited in memory because the 
Examine command uses this to indicate a 
byte that is not a displayable ATASCII code. 

A 600^0 or 600^0 or 600^0 " $#?3J 



8] RE gister 

REgister {r^h} 

To examine and alter the saved 6502 
registers. RE examines all the registers. RE 
r^h alters registers, r represents 
AXY.S.C.P as follows: 

A,X,Y are the corresponding registers 
S is the stack pointer 
C is the flags register 
P is the program counter 
h is a hexadecimal quantity [1 byte, 
except for P which is 2 bytes] 
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NOTE: This command is intended for those with 
the knowledge of machine language. 



Ex. TYPE: RE P^9AED 

RE A^9B, X^ED or 

RE 

E. Device Control 

These commands regulate the functions of the devices, 
such as the screen editor, the disk drive[s], a printer 
and/or interface module. 



1] RESET 
2] Text 
3] CLose 
4] ERror nn 

1] RESET * 

This command resets all devices that DOS 
recognizes. It also coldstarts the cartridge. 
It can be used while setting the disk drives, 
and the number of file buffers. To do this, 
type: 

Alter 709 ^buffers, drives 
RESET 

[drives is a bit map of the drives that you 
want and # buffers is the maximum number 
of I/O channels that you intend to have open 
at the same time to the disk]. This does not 
kill any user devices. It is most useful when 
changing buffers. 



* caution: Do not confuse the RESET command with 



the [system reset] key. 



Ex. TYPE: 

SCREEN 
DISPLAY: 



RESET 



Type Y if ok to coldstart 
cartridge? 



TYPE: 

SCREEN 
DISPLAY: 



Y 



DOS 



26 



2] Text 

This command rewrites the display list and 
causes the computer to display a clear text 
screen. It reopens the screen editor in 
mode □ and is equivalent to GR.O from 
BASIC. 



Ex. TYPE: T 

SCREEN 
DISPLAY: DOS 



3] CLose 

To close all open files, turn off the sound, 
reset the vertical blank vectors, and turn 
off the player missile graphics. It is similar, 
yet more powerful than the BASIC com- 
mand END. BASIC will automatically close 
files before it calls DOS. 



Ex. TYPE: 

SCREEN 
DISPLAY: 

Ex. TYPE: 

SCREEN 
DISPLAY: 

NOTE: 



4] ER ror nn 

This command displays the error message 
corresponding with nn, a decimal number. 
Numbers less than 1 28 are used by K-DOS 
errors. 

ER 144 



ERROR 144, DEVICE ERROR 
ER 38 

Incompatible disk drive 

A list of error messages may be found in 
Appendix A. 



DUP Special Commands 

These four commands offer special privileges for the Disk 
Utility Program. 

1] UDC 
2] Jdent 
3] KILL 
4] REVIVE 
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UDC User Defined Command 



A UDC is a command that permits the user 
to define a command that loads and runs a 
machine language program. 

The UDCs supplied on the system master 
diskette along with DOS include: 



TR]ANS, D:TRANS.SYS 

H]ELP, D:HELP.SYS 

U]DC, D:UDC.SYS 

CH]ERROR, D:CHERROR.SYS 

DISK]duplicate, D:DISKDUP.SYS 



] denotes minimum abbreviation when 
defining a UDC. When deleting a UDC, you 
may use the abbreviation, but not the ]. 

A UDC can exit with a BRK instruction or an 
RTS if the stack is preserved. You should 
use WEJOOT or INIT to save the copy of 
DOS with the UDC table to the disk. DOS 
commands take precedence over UDCs. 



Ex. TYPE: UDC 

SCREEN UDC manager V1 . 2 
DISPLAY: List, Add, DELete, INIT, Stop 



L List the UDC table 

INIT Clear the UDC table 

DEL cmd Delete the command from 

the UDC table 
A cmd {, } file Add the command to the 

UDC table 
Stop Halts the UDC program 
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2] 



x. TYPE: 

SCREEN 
DISPLAY: 



jdent 

A command to identify the version of DUP 
that is in use, repeating the K-DOS title. 

I 

K-DOS™ By K-Byte™ [same message as 

when DOS is booted] 

Copyright 1981 

KAY ENTERPRISES Co. 



3) KILL 

KILL deletes the DOS E: vectors and serial 
input/output patch. Useful if your program 
machine language accidentally wipes DUP 
out. 

DOS intercepts screen editor and serial 
input/output. If DUP program has been 
interfered with and will not run properly, 
KILL will prevent the use of the program. 

SCREEN 
DISPLAY: DOS 

TYPE: E 20A 

SCREEN 

DISPLAY: 020A^11 E8 E3 27 D1 EA B2 E7 
DOS 

TYPE: KILL 

SCREEN 
DISPLAY: DOS 

TYPE: E 20A 

SCREEN 

DISPLAY: 020A^11 E8 90 EA D1 EA B2 E7 



4] REVIVE 

REVIVE is the opposite of KILL. All errors 
used in DUP are equated in EQUATE. ASM. 
REVIVE allows DOS to accept, rather than 
intercept, the screen editor and serial input/ 
output. 
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COMMAND SUMMARY 

Disk Maintenance INIT n 

FORMAT n 
WBOOT {n} 

* DISKd up {scr{{,}dest}{/A}{AA/} 
{/F}{/P}} 

File Control Direct {filespec} {.output} 

Copy input {.output} 

DELete filespec {/N} 

LOC k filespec 

UN lock filespec 

REN ame file.filename 

APpend {sourcefile,} destfile 
*IRansfer filename {/SIRG} 

{,filename}{/SIRG} 
Program Control Back 

WARM 

COLD 

Xit 

UNLOAD 

LOMem 

DC {character} 
Machine Monitor Run file {/M } {/N } {/P } 

Load file {/M}{/N}{/P} 

Save file {/A} beg end { {init } start} 

Go {hhhh} 

Proceed {hhhh} 

Examine { ^first ►{, ^last ►} } 

Alter {adr}{*«} hex.... or "ascii 

REgister {r^h} 
Device Control RESET 

Text 

CLose 

ERror nn 
DUP Special *UDC 

Ident 

KILL 

REVIVE 

Indicates the minimum abbreviation. 

* Indicates a UDC command that normally 

resides in a disk file. 
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APPENDIX A Error Messages 



Error Error 
No. Name 



1 

2 



Illegal 
command 

Not enough 
memory 



8 Number? 



1 2 Go where? 



21 Bad load file 



32 Syntax? 

33 Switch? 

35 Filename 
too long 

36 Not a 
disk file 

37 No 
cartridge 

38 Incompatible 
disk drives 

39 Need 1 thru 
8 for disk # 



Cause and Recovery 

Type HELP for help. DOS didn't under- 
stand that command. 

The machine language program loads 
at too high a location, or the UDC table 
overflowed, or TRANS didn't have 
enough memory to load the whole file. 

You typed an illegal number. Periods 
and + or - signs are never legal in 
DOS. A-F is allowed for hexadecimal 
numbers only. 

You didn't specify an address to go to, 
and there is no run address from the 
last file loaded. Note: [system reset] 
destroys the run address. 

You tried to load a file that isn't a legal 
load file. Try specifying an extension. 
Note "File." will specify a null extension. 

There are extra or illegal parameters. 

Used incorrect Switch designator. 

You typed in an illegal filename. See 
"filename" in Glossary. 

You can only delete files on a disk drive. 

B and X commands will work only when 
you have inserted a cartridge to which 
you may return. 

You can not back up an 81 □ disk on an 
815. 

Disk drives are numbered from 1 to 8. 
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40 Illegal User 
Def'd 
Command 

41 Not Basic- 
use Back 



42 LOMEM out 
of range 

43 Can't overlay 
DOS 

44 Can't proceed 

128 **Break 

1 30 No such 
device 

1 36 End of file 

1 38 Device 
timeout 



1 39 Device NAK 

1 41 Cursor out of 
range 

1 44 Device error 

146 Funct. not 
implemented 

1 54 Concurrent 
mode I/O not 
active 

1 60 Bad drive 
num 



You tried to delete a UDC command 
that was not in the table. 

DOS cannot load or run Basic pro- 
grams. DOS only knows the internal 
format of machine language files, and 
those saved by DOS or the ASM/ED 
CARTRIDGE. 

You specified an illegal address for the 
LOMem command. 

You tried to load a file that loaded 
where DOS is. 

You hit [break] key. Will stop execution. 

You have tried to use an undefined 
device. Check for the correct device. 

No more data is listed in your file. 

You have issued an incorrect device 
number or specified the wrong device. 
Examine all connections. Check and 
retry the command. 

No response because of bad param- 
eters. Device may have received bad 
data from the computer. 

Cursor is out of the range for the mode 
you selected. 

This device cannot execute a legal 
command. Check if disk is write-pro- 
tected. 

The function is not contained in the 
handler. You are trying to use incom- 
patible commands and devices. 

See 850 Handler Manual. 

Drive numbers must be 1 thru 8. 
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o 

1 62 Disk full There are no more free sectors on 

your diskette. It is time for another 
diskette. 

1 64 File over- Sector does not contain information 
written from this file. 

1 65 Bad file name The filespec you have used has 

incorrect characters in it. See 
Glossary for correct file-specification. 

1 67 File locked You cannot append or delete a locked 

file. 

Q 

1 69 Directory full All the space in the directory has been 

used. 

1 70 File not found File does not exist. 

172 Incompatible File not created by DOS 2. OS or 
DOS format K-DOS. 

173 Can't format Bad sectors have been encountered, 
disk so disk cannot be formatted. 

O 

o 
o 
o 
c 



o 

o 
o 
o 
o 
o 
o 
o 
o 
c 
o 
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APPENDIX B FMS Patches 



The following list of patches may be used to change the FMS 
allowing you to recover files, etc. 

NOTE: These changes are reserved for the 
advanced programmer. Use with caution! 

"ALTER 41 ^0" from 3. This tells SIO to be quiet, so any 

I/O over the serial bus will be 
silent, including using the disk 
drive or printer. This is reset by 
[system reset] to 3. "POKE 
65,0" can be used in Basic 
programs. 

"ALTER 792 ^0" from 3. Use this to change the retry count 

inside of FMS from 3 times to 
256 times. This is helpful if the 
disk is hard to read. 

"ALTER 770^3" from F. Disk normally times out after 15 

seconds. This changes that to 3 
seconds. 
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APPENDIX C 



Glossary of Terms 



Addr Abbreviation for address of memory location. 

Arguments Variables listed in filename and in {} after the 
filenames; everything after the command. 

ASCII The American Standard Code for Information 
Interchange. 

Byte 8 bits; basic unit of measurement. 

Boot A subroutine which initializes the program as 

computer is powered up. 

Buffer Temporary holding area for data which may be 
further processed. K-DOS has an internal 256 
byte buffer for certain commands [Copy, DELete, 
Direct]. 

CC 6502 program status byte; the Flags Register. 

CIO Central input/output subsystem. 

D: Device reference to disk drive. 

Defaults Conditions of falling through if output is not 
specified; K-DOS has a series of defaults so that 
you don't have to specify common parts: 

nothing — D: 

n — ► Dn: 

filename — ► D:filename 

.filename — ► D:filename 

d:filename — ► d:filename 

dn;filename — «► dn filename 

Where n is a single digit, d is a single letter for a 
device name, and filename consists of a name of 
up to 8 alphanumeric characters, and an exten- 
sion of up to 3 characters. 

Certain commands, Direct, Load, Run, DELete 
[but not with /NOQUERY] have wildcard defaults. 
This is done after the previous defaults are done, 
and consists of: 
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D: — ► D:\* all files 

D: — ► D:name.* all namefiles 

with extensions 

D:name. — ► D:name. extensions only 
D:name.ext — ► D:name.ext just that file 

Abbreviation of destination, i.e. destination file, 
the receiving file during a transfer of information. 

Disk Utility Program. 

Device reference to the screen editor. 

Alphanumeric characters assigned to identify a 
particular file; up to 8 characters plus 3 additional 
characters in the extension. 

File specification consisting of 1 character device 
name, an optional device number, a colon, a file- 
name up to 8 characters and optional extension 
[consisting of a period followed by up to 3 
characters]. 

6502 status register 

File Management System. 

Kilobyte; 1024 bytes of memory. 

Lower case Indicates parameters for the commands; K-DOS 
accepts lower case input. 

N: Dummy device in K-DOS; anything written to it 

disappears without a trace; sends return to end 
of file. 

n Represents single digit. 

nn Represents decimal number, i.e. ERror nn. 

NOTE Retrieve I/O device's place. 

Object Code Another name for machine language. 

Object File A file with object code in it; DOS can load and 
generate files that work with DOS 2. OS and the 
ASSEMBLER cartridge. 

Parameters Variables which give additional information about a 
command, i.e. filenames, disk drive numbers, 
hexadecimal numbers. 



Dest 

DUP 

E: 

Filename 



Filespec 



Flags 
register 

FMS 

K 
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o 

Patches Repairs used to fix mistakes; see Appendix B. 

PC 6502 Program counter which indicates the loca- 

tion in memory where computer was executing 
program. 

POINT Set I/O device's place. 

G 

POKE To alter a memory location in BASIC. 

PEEK To examine a memory location in BASIC. 

ROM Read Only Memory; permanent memory storage 

which cannot be changed. 

RTS ASSEMBLER instruction; return from subroutine. 

Scr Abbreviation of source, as in source file; the file 

containing the information to be sent to the 
destination file. 

SIO Serial input/output. 

SIRG Short interrecord gaps referring to cassette 

tapes; see TRansfer command. 

Stack 6502 stack pointer; indicates current entry point 
pointer of a stack of information. 

Syntax The rules of commas, characters, notations, etc. 
necessary to properly execute a command. 

Text Files Units of information, i.e. lists, results, copies, 
which may or may not be a program. 

Tokenizing Process of converting BASIC instructions into 
symbols; for example, "Run" is reduced to 1 
symbol or byte. 

UDC User Defined Commands permit the user to 

define commands that run machine language 
programs. 

Upper Case Indicates parts necessary for input. For example, 
in the command Copy, the C is the only character 
needed for proper execution. With DELete, DEL is 
required. 

Vectors Pointers in memory, often to interrupt code. 
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VTOC Volume Table of Contents; bit map of all available 
sectors. 

Wildcards "?" and "*" -wildcard characters. 

"?" will replace any single character. 

"*" will replace multiple characters [rest of 
filename]. 
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INDEX 



A 

A [abort immediately] 14 

A [register] 25 

Address 22,23,24,25 

/All 4,14 

Alter .24,25,30 

APpend 18,30 

/Append 4,24 

Appendices 31-38 

ATASCII 9,25 

ASSEMBLER Cartridge . .1,3,19 

Asterisk 5 

Atari DOS 1,3,10 

Atari 850 1,6,7,10,26 

AUTORUN.SYS . . .7 

B 

Back 19,30 

BASIC 20,21,27 

BASIC cartridge ..... 1 ,7,1 9,20 

Boot 6 

Boot Errors 6 

BRK 9,28 

[Break] 4,8,9,24,28 

Buffer 19,21,22,26 

c 

C [continue trying] 14 

CHERROR.SYS 2,9,28 

CLose 20,24,27,30 

COLD 20,30 

Coldstart 20,21,26 

Colon 5 

Comma 5,10 

Copy 15,16,17,30 

[CTRL1] 4 

[CTRL3] 4,16,22 

D 

D: [disk drive] . . .5,15,16,17,18 

Defaults 35 

Defined Character [DC] 10,1 9,22 

DELete 15,17,28,30 

DEQU.ASM 2 

Dest file 18,19 



Destination disk 14,1 5 

Direct 15,16,30 

Disk drive 6,12,13,16 

DISKdup 13,14,15,30 

DISKDUP.SYS 2,13,28 

Display list 27 

DOS. SYS 2,12,13 

DUP 8,9,10,27 

Duplicate disk .13,14,15 

Duplicate file . 19 

E 

E:[screen editor] 9,15,16,17,26 

EDIT/ASM 20 

Ellipsis 5 

End 27 

EQUATE. ASM 2,29 

ERror 9,26,27,30 

Error messages .... 9,31 ,32,33 
Examine 22,25,30 

F 

Filename 8,10,18,19 

Filespec 17,18 

Rags register 25,36 

FMS 8,34 

/Forever . 4,14,1 5 

FORMAT 12,13,30 

G 

Go 24,30 

Glossary 35 

H 

HELPFILE.SYS 2 

HELP.SYS 2,28 

Hexadecimal 5,24,25 

Ident 27,29,30 

INIT 12,28,30 

Initialization 7 

K 

K-COM I 3 

Keys 4 

KILL 27,29,30 
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L 

L [list] 28 

Load 23,24,30 

LOCk 15,17,1a, 30 

LOMem 19,21,22,30 

Lowercase 10 

M 

Machine language 

monitor 9,22 

/Map .4,23,24,30 

Master diskette 2,3,6 

Memory 22,23,24,25 

N 

N: [dummy device] 17 

nn [decimal number] 26,27 

/Noinit 4,23 

/Noquery 4,1 7 

Note 10 

o 

Object file 23 

Optional parts 4 

p 

P: [printer] 5,17 

/Patch 4,23 

Patches 34 

Point 10 

Proceed 24,30 

Program counter 25 

/Put 13,14 

Q 

Q [quit] 1 4 

Question mark 5,14 

R 

RAM .21 

REgister 25,26,30 

Registers 24,25 

REName 18,30 

RESET 26,30 

Reset pointers 20 

[Return] 4 



REVIVE 27,29,30 

RTS 24,28 

Run 22,23,30 

s 

S [skip] 14 

Save 22,24,30 

Screen display 6,29 

Screen editor 16,26 

Sector 12,13,14 

Serial I/O 29 

/SIRG 5,19 

Source disk 14 

Source file 18 

Space 5 

SQUEEZE.SYS 2 

[Start] 4,9 

Status checking 8 

Switch 4 

Syntax 10 

[System reset] .4,8,9,20,25,26 

T 

Text . 16,26,27,30 

Track 12 

TRansfer 15,19,30 

TRANS. SYS 2,19,28 

u 

UDC 10,27,28,30 

UDC.SYS 2,28 

UNLOAD 19,21,30 

UNIock 18,30 

v 

Vector 27,29 

Version of DUP 29 

w 

WARM 19,20,30 

WBOOT 13,22,28,30 

Wildcard 5,16,35,38 

AA/rite 5,13,14 

Write protection 3 

x 

Xit .21,30 
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LIMITED WARRANTY 



K-BYTE will exchange this product within three months from 
date of purchase if defective in manufacture. Merchandise for 
exchange must be returned to K-BYTE™ along with proof of 
purchase. K-BYTE™ shall have no liability or responsibility to 
purchaser or any other person or entity with respect to any 
liability, loss or damage caused or alleged to be caused directly 
or indirectly by this product, including, but not limited to, any 
interruption of service, loss of business and anticipatory profits 
or consequential damages resulting from the use or operation 
of this product. This warranty gives you specific legal rights. 
You may also have other rights which vary from state to state. 



c 

K-DOS is completely compatible with Atari* 2. OS and other related 
software. K-DOS offers the programmer greater reliability, 
flexibility and control. 

C 

K-DOS features: 

• A machine language monitor which allows examination and 
alteration of memory in hexadecimal and displays ATASCII 
representation. 

• K-DOS is command line driven. 

• K-DOS is memory resident. 

• DOS commands may be executed when the BASIC or 
ASSEMBLER cartridge is in control. 

• Disk files may be directly transferred to Cassette. 

• Cassette files may be directly transferred to Disk. 

• Interception of the break instruction does not crash the system, 
but takes the user back into K-DOS. 

• New powerful commands reserve and erase memory. 

• K-DOS allows the user to create own commands. 

• K-DOS incorporates a null handler, speeds up testing and 
debugging. 

• Commands are English-like with abbreviations. 

• Error messages are given in English. 

This easily read handbook includes a pocket Command Summary 
Card. 

• Atari is the Registered Trademark of Atari, Inc. 

K-BYTE™, Division of Kay Enterprises Co. 




